﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html>
    <head>
        <meta content="Innovasys Document! X (http://www.innovasys.com)" name=GENERATOR>
        <!--DXMETADATA start type="MetaCharset" --><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"><!--DXMETADATA end-->
        <!--DXMETADATA start type="PageItemTitle" format="<title>Overview</title>" --><title>CustomizeOptions Object</title><!--DXMETADATA end-->
        <link href="stylesheets/axstylesheet.css" type=text/css rel=stylesheet>
        <script src="script/ax.js" type=text/javascript>
    </script>

    


<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
    <body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(4988);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../index.htm?page=XtremeCommandBars~CustomizeOptions.html";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="XtremeCommandBars~CustomizeOptions.html" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="template2/btn_prev_n.gif" border="0"></a><A href="XtremeCommandBars~CustomizeOptions_members.html" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="welcome_screen.htm">Codejock ActiveX Controls v15.3</A> &gt; <A href="XtremeCommandBars_P.html">Xtreme Command Bars</A> &gt; Objects &gt; <A href="XtremeCommandBars~CustomizeOptions.html">CustomizeOptions Object</A> &gt; </div>
	<div id="winchm_template_title">Overview</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div class=popupbubble id=dxseealsomenu><p id=dxseealsocontent><a href="#Bookmark4989">CustomizeOptions Members</a>
&nbsp;|&nbsp;<a href="#Bookmark4710">Customization Event</a>
&nbsp;|&nbsp;<a href="#Bookmark4687">CustomizedControl Property (Points to selected control during customization)</a>
&nbsp;|&nbsp;<a href="#Bookmark4994">ContextMenu Property</a>
&nbsp;|&nbsp;<a href="#Bookmark4995">CustomIcons Property</a>
&nbsp;|&nbsp;<a href="#Bookmark4998">ShowKeyboardPage Property</a>
&nbsp;|&nbsp;<a href="#Bookmark5001">ShowOptionsPage Property</a>
</p><!--DXMETADATA end --> 
        </div>
        <div id=pagetop>
            <div id=projectnamebanner>
                <table class=projectnametable cellspacing=0>
                    <tbody>
                        <tr>
                            <!--DXMETADATA start type="Literal" condition="childitems:itemtype=seealso" value="<td class='button'><a href='' id='seealsobutton' onclick='showSeeAlsoBox()'><img alt='See Also' border='0' src='axImages/seealso.gif' width=14 height=14></a></td>" --><td class='button'><a href='' id='seealsobutton' onclick='showSeeAlsoBox()'><img alt='See Also' border='0' src='axImages/seealso.gif' width=14 height=14></a></td><!--DXMETADATA end -->
                            <td>
                                <!--DXMETADATA start type="Phrase" Name="Product_Header" -->Xtreme Command Bars ActiveX Control v15.3<!--DXMETADATA end --> 
                            </td>
                            <td align=right>
                                <!--DXMETADATA start type="Variable" name="FeedbackLink" format="" --><!--DXMETADATA end -->
                            </td>
                        </tr>
                    </tbody>
                </table>
            </div>
            <div id=pagetitlebanner>
                <h1 class=dxh1>
                <!--DXMETADATA start type="PageItemTitle" -->CustomizeOptions Object<!--DXMETADATA end --></h1>
            </div>
        </div>
        <div id=pagebody valign="bottom">
            <!--DXMETADATA start type="IsNew" format="<script>document.all.pagebody.className = 'newTopic'</script>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="Description" source="Item" format="<h4 class=dxh4>$$Description$$</h4><p>%%description%%</p>" --><h4 class=dxh4>Description</h4><p>Represents a customization object that allows you&nbsp;customize how the CommandBar customization dialog is displayed.&nbsp; You can choose which pages to display in the dialog, and you can add you own custom controls to the right-click context menu that is displayed during button customization when a control is right-clicked.&nbsp; You even have the ability to delete existing controls from the context menu.</p><!--DXMETADATA end --> 
            <!--DXMETADATA start type="Scrap" name="_MEMBERS_LINK" format="<p>%%scrap%%</p>" --><p>For a list of all members defined in this module, see <a href="#Bookmark4989">CustomizeOptions members</a>.</p><!--DXMETADATA end --> 
            <!--DXMETADATA start type="Diagram" source="item" format="<h4 class=dxh4>$$OBJECT_MODEL$$</h4><p>%%Diagram%%</p>" --><h4 class=dxh4>Object Model</h4><p><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0><TR><TD NOWRAP>
<a href="#Bookmark4987"><img src="cDiagramImages/XtremeCommandBars~CustomizeOptions~213.gif" border=0></a><br><img src="cDiagramImages/parmult.gif" border=0><a href="#Bookmark5070"><img src="cDiagramImages/XtremeCommandBars~CustomIcons_(ImageManagerIcons)~213.gif" border=0></a><img src="cDiagramImages/paracros.gif" border=0><a href="#Bookmark5056"><img src="cDiagramImages/XtremeCommandBars~GetImage_(ImageManagerIcon)~213.gif" border=0></a><br><img src="cDiagramImages/parchild.gif" border=0><a href="#Bookmark4006"><img src="cDiagramImages/XtremeCommandBars~ContextMenu_(CommandBar)~213.gif" border=0></a>
</TD></TABLE>
</p><!--DXMETADATA end --> 
            <!--DXMETADATA start type="TaggedComment" source="Item" id="##MODULE_REMARKS" format="<h4 class=dxh4>$$Remarks$$</h4><p>%%comment%%</p>" --><h4 class=dxh4>Remarks</h4><p><P>CustomizeOptions can only be used within the <A href="#Bookmark4710">Customization event</A>.&nbsp;</P>
<P>The Customize dialog will allow the user to customize the toolbar and menu bar.&nbsp; The CommandBars.EnableCustomization(True) method must be called to enable Customization.</P></p><!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="ITEM_LIST_WITH_HEADER" namespace="implemented interface" source="Item" filter="" format="<h4 class=dxh4>$$Interfaces$$</h4>%%filtereditemlist%%" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="TaggedComment" source="Item" id="##MODULE_EXAMPLEINTRO" format="<h4 class=dxh4>$$Example$$</h4><p>%%comment%%</p>" --><!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="INLINE_EXAMPLE" namespace="Example" source="Item" filter="type=inline" NoHeader="True" NoFooter="True" format="<h4 class=dxh4>$$Example$$</h4>,format= %%%%filtereditemlist%%" --><h4 class=dxh4>Example</h4><DIV Class=LanguageSpecific Name=Example_VB><p><SPAN class="lang">[Customizing the CommandBar Customization Dialog and Context Menu (Visual Basic)]</SPAN>&nbsp;This sample illulstrates how to customize the CommandBars Customization dialog and the context menu that is displayed when a user right-clicks on a control during customization.  You will also see how to add your own custom images to the Change Buttom Icon popup in the context menu.</p><DIV Class=LanguageSpecific Name=Code_VB><TABLE Class="CodeContainerTable" CellPadding="0" CellSpacing="0" Border="0"><TR><TD NOWRAP><CODE Class="VB"><font class='keyword'>Private</font> <font class='keyword'>Sub</font> CommandBars_Customization(<font class='keyword'>ByVal</font> Options <font class='keyword'>As</font> XtremeCommandBars.ICustomizeOptions)<BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'        Choose which pages to display in the customization dialog</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Do not show the KeyBoard page in the customization dialog</font><BR/>
&nbsp;&nbsp;&nbsp;Options.ShowKeyboardPage = <font class='keyword'>False</font><BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Do not show the Options page in the customization dialog</font><BR/>
&nbsp;&nbsp;&nbsp;Options.ShowOptionsPage = <font class='keyword'>False</font><BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'        Add custom controls to the context menu that is displayed when a control is</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'        right-clicked during customization</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Add an edit control to the context menu that is displayed when the user right-clicks a</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'control during customization.  Passing a 4 in as the "Before" parameter will insert this</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'edit control as the fourth control in the context menu.  The control will have a caption</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'label of "Parameter."  When this control is clicked, the execute event is fired and</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'the control will have an Id of ID_EDIT_PARAM.  See description of CustomizeOptions.ContextMenu</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'and CommandBars.CustomizedControl for more information on adding control to the context menu.</font><BR/>
&nbsp;&nbsp;&nbsp;Options.ContextMenu.Controls.Add xtpControlEdit, ID_EDIT_PARAM, <font class='string'>&quot;Parameter&quot;</font>, 4<BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'        Adding Images to the "Change Button Icon" popup in the contect menu</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'==========================================================================================================</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'This will illustrate how to add your own custom images to the "Change Button Image" popup</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'that allows users to change the image of a control.</font><BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Array of commands used to load images from a bitmap, this will be the value assigned to the</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'controls IconId property.  The images will be displayed in the "Change Button Image" popup of the customization context menu</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='keyword'>Dim</font> ChangeButtonImageIconArray(0 <font class='keyword'>To</font> 7) <font class='keyword'>As</font> <font class='keyword'>Long</font><BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'There are 8 icons in the Bitmap file, the bitmap file is 128x16,</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'which contains 8 16x16 icons. You need to make sure that there is</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'an element in the array for each icon in the Bitmap.</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Width of icons = Width of Bitmap / number of elements in array</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'I.e. Width of icons = 128/8 = 16</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'These values represent the IconId that will be assigned to the control, this</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'allows you to determine which icon is being used for your controls.</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'IconId can not be Zero (0), so do not assign 0 to any of the array elements</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'IMPORTANT: The IconId must start with 1.  So IconId = 1,2,3,4,5,....N</font><BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(0) = 1<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(1) = 2<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(2) = 3<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(3) = 4<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(4) = 5<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(5) = 6<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(6) = 7<BR/>
&nbsp;&nbsp;&nbsp;ChangeButtonImageIconArray(7) = 8<BR/>
<BR/>
&nbsp;&nbsp;&nbsp;&nbsp;<font class='comment'>'Remove the "built in" images provided with the suite</font><BR/>
&nbsp;&nbsp;&nbsp;Options.CustomIcons.RemoveAll<BR/>
<BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Passing the ChangeButtonImageIconArray for the "Commands" parameter will add an icon to the collection</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'of icons for each item in the array. So Number of icons added = Number of elements in array.</font><BR/>
&nbsp;&nbsp;&nbsp;<font class='comment'>'Icon width = Total width of Bitmap/Number of elements in array.</font><BR/>
&nbsp;&nbsp;&nbsp;Options.CustomIcons.LoadBitmap App.Path & <font class='string'>&quot;\Icons\ChangeButtonIcons.bmp&quot;</font>, ChangeButtonImageIconArray, xtpImageNormal<BR/>
<BR/>
<font class='keyword'>End</font> <font class='keyword'>Sub</font></CODE></TD></TR></TABLE></DIV></DIV>
<!--DXMETADATA end --> 
            <!--DXMETADATA start type="FilteredItemList" scrap="MENU_LINK" namespace="seealso" source="Item" filter="" NoHeader="True" NoFooter="True" format="<h4 class=dxh4>$$See_Also$$</h4><p id=dxseealsocontent>%%filtereditemlist%%</p>" --><h4 class=dxh4>See Also</h4><p id=dxseealsocontent><a href="#Bookmark4989">CustomizeOptions Members</a>
&nbsp;|&nbsp;<a href="#Bookmark4710">Customization Event</a>
&nbsp;|&nbsp;<a href="#Bookmark4687">CustomizedControl Property (Points to selected control during customization)</a>
&nbsp;|&nbsp;<a href="#Bookmark4994">ContextMenu Property</a>
&nbsp;|&nbsp;<a href="#Bookmark4995">CustomIcons Property</a>
&nbsp;|&nbsp;<a href="#Bookmark4998">ShowKeyboardPage Property</a>
&nbsp;|&nbsp;<a href="#Bookmark5001">ShowOptionsPage Property</a>
</p><!--DXMETADATA end --><!--DXMETADATA start type="FilteredItemList" scrap="MENU_LINK" namespace="example" source="Item" filter="type=linked" NoHeader="True" NoFooter="True" format="><!--DXMETADATA end --><!--DXMETADATA start type="Variable" name="CopyrightNotice" format="><!--DXMETADATA end --></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2018. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>

